home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / VIG-PM11.ZIP / PROMAT.DOC < prev    next >
Text File  |  1995-06-13  |  12KB  |  226 lines
  1. ProMatrix v1.1 by ViGilante on 6/13/95
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3. A Light bar matrix, highly configurable, reliable, bug-free, backdoor-free,
  4. and maintenance-free.
  5.  
  6. This PPE is a companion to ProVote, a new user voting PPE for PCBoard.  It
  7. was designed to work in conjunction with ProVote, but will work just as well
  8. without it. 
  9.  
  10. Please note that this PPE has been compiled with PPLC v3.10, so PCB v15.21 is
  11. absolutely required.  
  12.  
  13.  
  14. Upgrade Installation
  15. ~~~~~~~~~~~~~~~~~~~~
  16. If you are upgrading from v1.0, be advised that the formats for STRINGS.DAT
  17. and PROMAT.CNF have been altered slightly; you will need to either use the
  18. ones included here or mofify your current ones for this version to work
  19. properly.  Make sure to jot down your reg code if you overwrite your old
  20. PROMAT.CNF file.
  21.  
  22.  
  23. Quick Setup
  24. ~~~~~~~~~~~
  25. Create a separate directory, perhaps c:\pcb\ppe\promat, and unzip everything
  26. into this directory.  Do NOT unzip it to the same dir as ProVote, if you
  27. are running it, as some files WILL conflict.  
  28.  
  29. You should install this in your WELCOME display file, usually found in the
  30. \PCB\GEN directory.  All you need is one line in this file:
  31.  
  32. -----Start---------------------
  33. !c:\pcb\ppe\promat\promat.ppe
  34. -----Stop----------------------
  35.  
  36. If you have some sort of ansi you want to be displayed in the WELCOME file
  37. that's OK, just add the above line to the bottom of the WELCOME file.  Put
  38. @WAIT@ (in uppercase) as the second to last line so that people have a
  39. chance to see the text in the WELCOME file before ProMatrix loads.
  40. Also, put a @QOFF@ at the TOP of the file so they cant abort the display of
  41. your ansi, effectively aborting the execution of PROMATRIX in addition.
  42.  
  43. Make sure PCB is set to allow one name users (G,C from PCBSETUP), and put
  44. a FAKE.PPE (or similar) into PCBTEXT record #260.  If you don't already
  45. have one, it should consist of a single line: KBDSTUFF CHR(13).
  46.  
  47.  
  48. Detailed Configuration
  49. ~~~~~~~~~~~~~~~~~~~~~~
  50. PROMAT.CNF: Line 1: Registration code, or 000000 if not registered.
  51.             Line 2: Number of matrix screens to randomly display.  You must
  52.                     have a MATRIXx.PCB and a MATRIXx.CNF for each, and
  53.                     numbering must start at 1.
  54.             Line 3: System Password; NONE to disable.  Password needed to
  55.                     gain entry into the BBS.
  56.             Line 4: New User Password; NONE to disable.  Password needed to
  57.                     apply as a new user.
  58.             Line 5: Security level needed to find out the system password.
  59.             Line 6: Number of password failures (any type) before the user
  60.                     is automatically disconnected.
  61.             Line 7: Timeslot password.  Here you can define a time of day
  62.                     during which only people with this password can logon.
  63.             Line 8: Time to begin, format HH:MM in military time.
  64.             Line 9: Time to end, format HH:MM in miilitary time.
  65.             Line10: YES if you are using PROVOTE.PPE.  If this is the case
  66.                     and you put YES here, then they will be allowed to logon
  67.                     (without knowing the system password)... as long as you
  68.                     have PROVOTE installed correctly, when they run PROVOTE,
  69.                     it will detect that this is a newuser being voted on and
  70.                     show his (her?) current stats, and then hangup on them.
  71.                     Your systems' security cannot be breached at any time.
  72.             Line11: YES if you would like ProMatrix to create and maintain
  73.                     log files detailing all actions performed at the matrix.
  74.             Line12: Minimum baud rate required to access the matrix.  Even
  75.                     though PCB has a similar feature built in, by using this
  76.                     you can control who gets in with a low baud rate via a
  77.                     password.
  78.             Line13: Password for low baud restriction.
  79.             Line14: Number of additional minutes to give a user when composing
  80.                     feedback.  By default, PCB only allows (5) minutes before
  81.                     actually logging in which might prove inadequate when
  82.                     trying to write a letter.
  83.  
  84.  
  85. STRINGS.DAT: Almost any string can be replaced with a file or another PPE,
  86.              by simply placing the path and filename (preceded by either !
  87.              or %) on the line you want to replace.  This works EXACTLY like
  88.              PCBTEXT.  Just make sure that if you replace a string where
  89.              input is required from the user, it is YOUR responsibility to
  90.              leave the cursor in the spot you want to get input from once
  91.              control returns back to ProMatrix.
  92.  
  93. CARPET.RED: Put the names of people you would like to 'bypass' the New User
  94.             Password check in here, they will be allowed to apply as if there
  95.             was no NUP if one is installed.
  96.  
  97. MATRIXx.PCB: These are your logon screens, randomly displayed.  It can be
  98.              a straight ansi or straight PCB @ codes file, just look at the
  99.              ones that are included and I am sure you can figure out what to
  100.              do.
  101.  
  102. MATRIXx.CNF: Every logon screen needs its own .CNF file.  The format is: 
  103.              
  104.              Line 1: Metacommand for first lightbar.  This may be a little
  105.                      confusing...  there are 5 built in metacommands: LOGON,
  106.                      APPLY, CHECK, FEEDBACK, and LOGOFF.  In addition, you
  107.                      can create your own commands by putting the PATH\NAME of
  108.                      a ppe you would like to run or a file you would like to
  109.                      display, just like in PCBTEXT.  Don't try to use color
  110.                      codes with the 5 built in commands,they never get
  111.                      displayed, they are just "directives" to tell the PPE
  112.                      what to do when a user chooses this lightbar.
  113.              Line 2: X position (space) Y position (space) number of chars
  114.                      of this lightbar (not including any color codes).
  115.                      This is where you want the lightbar to appear, and the
  116.                      length of displayed characters.  The coordinates
  117.                      should coincide with the text in the corresponding
  118.                      MATRIXx.PCB file.
  119.              Line 3: Text (including color) for this lightbar when it is
  120.                      HILITED.  Note that the UNHILITED text and colors are
  121.                      (should be) built into the corresponding MATRIXx.PCB
  122.                      file.
  123.              
  124.              Line 4: Blank line.  You must separate each 3-line block with
  125.                      a blank, makes it much easier to edit also.
  126.  
  127.              Repeat lines 1 through 4 as necessary for each lightbar you
  128.              want.  You can have a maximim of 9.  While this all may seem
  129.              a little complicated, you should also realize that you have
  130.              before you an unmatched level of configurability; you can have
  131.              each lightbar appear anywhere you want, be as long or as short
  132.              as you want, in any color you want, and do whatever type of
  133.              command you might want by integrating other ppe's into the
  134.              matrix.  If it still seems confusing just look at the samples
  135.              provided, and see how I installed the "Chat with Sysop" option
  136.              into each matrix screen.  It is set up by default to load my
  137.              OCOMMAND.PPE (included in SuperChat) in K:\PCB\PPE\SCHAT, you
  138.              will most likely want to change the path if nothing else.
  139.  
  140.  
  141. Registration
  142. ~~~~~~~~~~~~
  143. This PPE is totally free, all you need to do is call Velvet Underground and
  144. use the "Reg a ViG! PPE" option from the Matrix.  Be prepared with your NAME
  145. or HANDLE and BBS NAME _exactly_ as it appears in pcbsetup, double check by
  146. looking in PCBOARD.DAT.  Line #2 is your name, and line #94 is your BBS name.
  147.  
  148. If you are running a cracked version, GOOD LUCK!  I hope you are very
  149. confident that the person who cracked this knows exactly what he is doing,
  150. the 'protection' routines are tied into a lot of other functions, and if
  151. altered could produce unpredictable (at best) results.  All you need to do is
  152. make a 30 second phone call.
  153.  
  154. Donations are certainly accepted if you feel so compelled, and I won't even
  155. mention the many hours of programming/debugging/testing/whatever spent on
  156. this thing. :)  Cash, old hardware, or even a good leech account on your
  157. board is always appreciated.
  158.  
  159. Velvet Underground (1) 516-826-0412 USR Dual 33.6k
  160. Velvet Underground (2) 516-785-8187 USR Dual 33.6k
  161. Velvet Underground (3) 516-PRI-VATE USR Dual 33.6k
  162.  
  163.  
  164. Enjoy
  165. ~~~~~
  166. Thats about it, if you have any questions or comments you can reach me
  167. on my board, many other quality boards and nets, Internet address
  168. vigilant@liii.com, or Prodigy @bwvr36c.
  169.  
  170.  
  171. Other ViG! Utilities:
  172. ~~~~~~~~~~~~~~~~~~~~~
  173. PROMATRIX  : Light Bar Logon Matrix.  Many features, incredibly configurable.
  174.              Companion to ProVote.
  175.              Current version: 1.1     Filename: VIG-PM11.ZIP
  176.  
  177. LOGTAME    : Keep those CALLERx logs under control!  Saves you money by
  178.              freeing up untold meggage! :)
  179.              Current version: 1.0     Filename: VIG-LT10.ZIP
  180.  
  181. WACKOPROMPT: Floating "SLAM ENTER" prompt replacement.  Very unique, and
  182.              completely configurable.
  183.              Current version: 1.0     Filename: VIG-WP10.ZIP
  184.  
  185. APPCENTER  : Light Bar Application Center.  Have your users apply for dist
  186.              sites, couriers, networks, anything.  Completely configurable.
  187.              Current version: 1.0     Filename: VIG-AC10.ZIP
  188.  
  189. PROVOTE    : Light Bar New User Voting.  Better than any NUV that is BUILT
  190.              IN to a BBS software, much less a PPE.
  191.              Current version: 1.2     Filename: VIG-PV12.ZIP
  192.  
  193. PROMPTS    : Replaces 52 of your PCBTEXT prompts, totally revamping the entire
  194.              application procedure, logon procedure, F6 Online user editor
  195.              function, and the (C) subcommand form the (7) User Edit sysop
  196.              command.  100% configurable.
  197.              Current version: 1.0     Filename: VIG-PR10.ZIP
  198.  
  199. PROUSEREDIT: Light Bar User Editor.  For sysops to edit all users, or as the
  200.              (W) command for a user to edit himself.  Emulates PCBSM.
  201.              Current version: 1.0     Filename: VIG-PU10.ZIP
  202.  
  203. SUPERLOGON : "Forum hack" features: broadcast logon to nodes, turbo login,
  204.              random stats, last callers, automessage, one liners, more.
  205.              Current version: 2.0     Filename: VIG-SL20.ZIP
  206.  
  207. CONVERT!   : Successor to PIPE2PCB.  Converts pipe color codes on incoming
  208.              fido mail into standard ANSI color codes on the fly.
  209.              Current version: 1.1     Filename: VIG-C!10.ZIP
  210.  
  211. RUMOURS    : Forum-hack style rumours, completely configurable.  Source
  212.              code included.
  213.              Current version: 2.0     Filename: VIG-RU20.ZIP
  214.  
  215. PCRENFORCER: Enforce Post Call Ratios the RIGHT way.  Totally bars non-PCR
  216.              compliant user from downloading until they post enough messages.
  217.              Current version: 2.0     Filename: VIG-PE20.ZIP
  218.  
  219. SUPERCHAT  : Really nice split screen chat, with a few unique and very handy
  220.              features.
  221.              Current version: 1.1     Filename: VIG-SC11.ZIP
  222.  
  223. MORETIME   : Give more time to users who know the correct password, totally
  224.              independant of security levels.  Source code included.
  225.              Current version: 2.0     Filename: VIG-MT20.ZIP
  226.